home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / thuds21.zip / THUDS.DOC < prev    next >
Text File  |  1993-01-15  |  12KB  |  330 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                      "The Ultimate Donation System"
  8.                                Version 2.1
  9.  
  10.                               Presented by
  11.  
  12.                           SDP Software Systems
  13.                           Steve Page - Author
  14.  
  15.                               Supported by
  16.  
  17.                            The SpeakEasy BBS
  18.                              (407)291-4626
  19.                          (First Call Download)
  20.  
  21.  
  22.  
  23.  
  24. INTRODUCTION:
  25. ____________
  26.  
  27. The Ultimate Donation System (THUDS) provides you, the Sysop, a convenient
  28. way to receive donations from users desiring to contribute to your BBS
  29. System. The THEDIT20 utility offers numerous functions to make the
  30. Sysops life a whole lot easier.
  31.  
  32. This door will quickly become your "favorite" as it will pay for itself
  33. with just one user donation.  Remember - this will be the only door you
  34. have installed that will put a smile on your face every time you see it
  35. opened............[g]
  36.  
  37.  
  38. FEATURES:
  39. ________
  40.  
  41.  
  42.     * Prints confirmation letters for you to mail to the user
  43.     * Prints envelopes for mailing confirmation letters
  44.     * Writes text record to disk
  45.     * Prints record to printer
  46.     * Provides financial reporting
  47.     * Supports most Major Credit Cards
  48.     * Supports all Major BBS Software
  49.     * Network compatible
  50.     * Share compatible
  51.     * Multi-Node compatible
  52.     * Highly configurable
  53.     * Speeds to 38,400
  54.     * Supports Non-standard ports and IRQ's
  55.     * ANSI and ASCII screens
  56.     * Includes "specialized Utility" (THEDIT) that provides many powerful
  57.       functions for Sysop utilization
  58.  
  59.  
  60.  
  61.  
  62. INSTALLATION:
  63. ____________
  64.  
  65. Installation is simple!!! Create a directory to hold all of the THUDS
  66. files and then unzip all files in THUDS21.ZIP into this directory.
  67. A sample directory would be: C:\PCB\DOORS\THUDS
  68.  
  69.  **** YOU MUST HAVE A COPY OF BRUN45 IN A DIRECTORY IN YOUR PATH ****
  70.  
  71. FILES INCLUDED SHOULD BE:
  72. _________________________
  73.  
  74.  THUDS21.EXE ---- Main Door Program.
  75.  THEDIT20.EXE---- Utility Program - "The Heart Of The System".
  76.  THUDS ---------- Sample batch file.
  77.  PRICE ---------- Sample ASCII pricing options screen. (modifiable)
  78.  PRICEG --------- Sample ANSI pricing options screen.  (modifiable)
  79.  ADDRESS -------- Sample ASCII address/message screen. (modifiable)
  80.  ADDRESSG ------- Sample ANSI address/message screen.  (modifiable)
  81.  THUDS.CFG ------ Sample Node 1 configuration file.
  82.  THUDS2.CFG ----- Sample Node 2 configuration file.
  83.  FILE_ID.DIZ ---- Description file for PCBoard and others.
  84.  REGISTER.FRM --- This is an important file! Thanks for the donation...
  85.  THUDS.DOC ------ The file you are reading now.
  86.  CREDIT.LET------ Sample letter for Credit Card Confirmation.
  87.  THUDS.LET ------ Sample letter for Check/Money Order payment.
  88.  DONOR.DAT ------ Sample data base file.
  89.  HISTORY.DOC----- History of improvements/fixes.
  90.  
  91. Change to the directory that the THUDS files are in, grab your favorite
  92. text editor and lets make the necessary changes to enable operation on
  93. your system.
  94.  
  95. The sample batch file looks like this:
  96.  
  97. ECHO OFF
  98. C:
  99. CD\PCB\DOORS\THUDS    <-- Path to the THUDS files
  100. THUDS21 THUDS.CFG     <-- THUDS.CFG "MUST" follow THUDS20
  101. CD\PCB                <-- Change directory to main BBS directory
  102. BOARD                 <-- Call your BBS batch file
  103.  
  104.  
  105. A sample batch file for NODE 2 would look like this:
  106.  
  107. ECHO OFF
  108. C:
  109. CD\PCB\DOORS\THUDS
  110. THUDS21 THUDS2.CFG
  111. F:                <- or what ever the drive # is for your second node!
  112. CD\PCB2      ^-----------Note!!!
  113. BOARD2
  114.  
  115. The batch file for each node must go in that nodes main BBS directory!
  116.  
  117. If setting up doors (and batch files for them) is new to you, go to your
  118. BBS software documentation for instructions.
  119.  
  120. BATCH FILE TIP:  If you would like the door to appear seamless to the
  121.                  user, name your batch file DONATE and then modify
  122.                  your main menu by adding "Type DONATE to contribute"
  123.                  as a user command.  Works great!
  124.  
  125. ****IMPORTANT*****
  126.  
  127. In order for the THEDIT20.EXE to function properly, the configuration
  128. file for NODE 1 MUST BE NAMED THUDS.CFG......  The config file for a
  129. second node would be named THUDS2.CFG and so on.
  130.  
  131. A sample THUDS.CFG file looks like this:
  132.  
  133. C:\PCB\PCBOARD.SYS         <--Line 1
  134. The SpeakEasy BBS          <--Line 2
  135. Steve                      <--Line 3
  136. Page                       <--Line 4
  137. 00000                      <--Line 5
  138. Y                          <--Line 6
  139. Y                          <--Line 7
  140. Y                          <--Line 8
  141. Y                          <--Line 9
  142. Y                          <--Line 10
  143. 1                          <--Line 11
  144. LPT1                       <--Line 12
  145. 5057 Bermuda Circle        <--Line 13
  146. Orlando Fl 32808           <--Line 14
  147.  
  148.  
  149. rem  line  1 = Drive and path to PCBOARD.SYS/DOOR.SYS/ETC...
  150. rem  line  2 = Name of your BBS
  151. rem  line  3 = Sysop First Name
  152. rem  line  4 = Sysop Last Name
  153. rem  line  5 = registration #  (leave 00000 if not registered)
  154. rem  line  6 = Do you want to use credit card function? (Y or N)
  155. rem  line  7 = Do you want to use Visa (Y or N)
  156. rem  line  8 = Do you want to use MasterCard (Y or N)
  157. rem  line  9 = Do you want to use Discover (Y or N)
  158. rem  line 10 = Do you want to use American Express (Y or N)
  159. rem  line 11 = Number of confirmation letters to print! (Must be 0, 1 or 2)
  160. rem  line 12 = Printer port (must be LPT1, LPT2, LPT3, COM1 OR COM2)
  161.                Your selection depends on how you have your system
  162.                configured!  Most will be LPT1!!!
  163. rem  line 13 = Sysops street address for return address on envelope
  164. rem  line 14 = Sysops City/State/Zip for return address on envelope
  165.                (No comma's, dash's, periods, etc. in lines 13 or 14)
  166.  
  167.  
  168. A sample THUDS2.CFG (config file for node 2) looks like this:
  169.  
  170.  
  171. F:\PCB2\PCBOARD.SYS        <--Line 1 NOTE: F:\PCB2\PCBOARD.SYS
  172. The SpeakEasy BBS          <--Line 2       ^     ^
  173. Steve                      <--Line 3
  174. Page                       <--Line 4
  175. 00000                      <--Line 5
  176. Y                          <--Line 6
  177. Y                          <--Line 7
  178. Y                          <--Line 8
  179. Y                          <--Line 9
  180. Y                          <--Line 10
  181. 1                          <--Line 11
  182. LPT1                       <--Line 12
  183. 5057 Bermuda Circle        <--Line 13
  184. Orlando Fl 32808           <--Line 14
  185.  
  186.  
  187. A config for a NODE 3 would be the same except for the first line which
  188. would be I:\PCB3\PCBOARD.SYS
  189.          ^     ^
  190. All configuration files MUST go in the directory with the rest of
  191. your THUDS files. ie. C:\PCB\DOORS\THUDS
  192.  
  193. The THUDS.LET file:
  194. ___________________
  195.  
  196. This file is the confirmation letter that is printed either via the door
  197. at that time of contribution or with the THEDIT20.EXE at a later time.
  198. This file is meant to be used for a check/cash confirmation letters
  199. The header of the letter and the first paragraph is generated
  200. automatically by the system.  The text that is in the THUDS.LET file is
  201. totally yours to do with as you please.  Use your favorite text editor
  202. and write the letter that suits your situation.
  203.  
  204. The CREDIT.LET file:
  205. ____________________
  206.  
  207. This file is the same as the THUDS.LET above and will be printed when
  208. your user chooses to contribute via a credit card. The system auto-
  209. matically selects the correct letter to print based on which way he/she
  210. chooses to contribute. (Check or Credit Card)
  211.  
  212. The PRICE (ASCII) and PRICEG (ANSI) files:
  213. __________________________________________
  214.  
  215. This file displays the donation options to your user!  The ASCII file
  216. can be created with any text editor while the ANSI file can be created
  217. with The Draw or PCB Draw!  The sample PRICEG file included was done
  218. with The Draw and can be modified to meet your own requirements! You may
  219. have to experiment a little to get the display alignment correct.  The
  220. file included displays perfectly!
  221.  
  222. This is a good place to tell you that the system will accept whatever
  223. $ amount the user types in.  The $ amount you put in the PRICE and PRICEG
  224. file does not limit the user from entering a different $ amount!  Maybe
  225. you will get lucky and someone will type in 500.00. [grin] The system
  226. will handle that!
  227.  
  228. The ADDRESS (ASCII) and ADDRESSG (ANSI) files:
  229. ______________________________________________
  230.  
  231. This file displays a final message to the user, prior to the closing
  232. screen, that provides mailing instructions; or what ever you would like
  233. them to know.  Once again use any text editor and The Draw!
  234.  
  235. BBS SOFTWARE SUPPORTED:
  236. ______________________
  237.  
  238. This door supports PCBOARD 12.1 through 14.5a, RBBS, WILDCAT, DOORSYS,
  239. etc....... The default is to PCBOARD 14.5!  Other BBS software requires
  240. an additional command line option in your batch file.  They are listed
  241. below:
  242.  
  243. A sample batch file for DOOR.SYS would look like this:
  244.  
  245. ECHO OFF
  246. C:
  247. CD\BBS\DOORS\THUDS
  248. THUDS21 THUDS.CFG /DOORSYS
  249. CD\BBS
  250. BBS.BAT
  251.  
  252. ENVIRONMENT VARIABLES:
  253. ______________________
  254.  
  255. This door is written with DOORFRAME (by Ted Freeman) and supports
  256. COM 1-4 on the standard IRQ's - COM1/COM3 - IRQ4 and COM2/COM4 = IRQ3.
  257. If you wish to use a non-standard IRQ, add the IRQ number after the
  258. configuration filename.  If you want to use COM1 and IRQ5, the command
  259. line would look like:  THUDS21 THUDS.CFG /5
  260.  
  261. FOSSIL DRIVER SUPPORT:
  262. ______________________
  263.  
  264. DOORFRAME supports the use of Fossil drivers.  To tell the door to use
  265. the Fossil driver instead of the standard COM ports, just put /FD on the
  266. command line.  Like this:  THUDS21 THUDS.CFG /FD  This indicates that
  267. a Fossil driver is present and should be used.
  268.  
  269. REGISTRATION:
  270. _____________
  271.  
  272. Registration is required if you continue using The Ultimate Donation
  273. System for more then a period of 30 days.  The unregistered version of
  274. the DOOR portion of THUDS is fully functionaL. The unregistered version
  275. of the THEDIT2O.EXE UTILITY, which is the real heart of the system, will
  276. handle a maximum of 20 records in the data base.  Obviously, this is to
  277. encourage your support of the author!  When you register, the "NON
  278. REGISTERED VERSION" will be removed from all screens and will be replaced
  279. with your BBS name and YOUR name.
  280.  
  281. To register your copy of The Ultimate Donation System, fill out the
  282. registration form supplied within the THUDS21.ZIP file.  Please mail the
  283. form along with a donation of $20.00 (check or money order) made
  284. payable to STEVE PAGE.  The address is on the registration form!
  285. Also, make sure you fill out the BBS name and Sysop name EXACTLY the
  286. way you have it in your configuration file.  Your registration code is
  287. based on a mathematical algorithm using this information!
  288.  
  289. Upon receipt of your registration form, I will pre-register you on
  290. The SpeakEasy BBS.  You will then be able to call The SpeakEasy to
  291. receive your registration code.  Please allow 7 to 10 days prior to
  292. calling to insure that your code will be waiting for you.  If you
  293. prefer, I will mail your registration code to you.  Make sure you
  294. include a self addressed envelope!
  295.  
  296. SUPPORT:
  297. ________
  298.  
  299. If you have questions regarding The Ultimate Donation System, I can be
  300. reached via RIME BBS-DOORS conference or at The SpeakEasy BBS. The
  301. SpeakEasy BBS is the official support BBS for all SDP SoftWare Systems.
  302.  
  303. THANK YOUS!
  304. ___________
  305.  
  306. I would like to thank Michael Goetz, Sysop of The Caverns EBBS and
  307. author of Majic SoftWare Doors, and Jim Murphey, Sysop of The Coffee
  308. Shop BBS for BETA testing this system.
  309.  
  310. I would also like to thank Ted Freeman for providing the DOORFRAME
  311. libraries that the door portion of this system was written with.
  312.  
  313.  
  314. LEGALITIES:
  315. ___________
  316.  
  317. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  318. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO
  319. ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  320. PURPOSE.  IN NO EVENT SHALL THE AUTHOR OF ANYONE INVOLVED WITH THE
  321. CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR ANY DIRECT,
  322. INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES RESULTING FROM THE USE OF
  323. THIS PROGRAM.  YOUR USE OF THIS PROGRAM CONSTITUTES YOUR AGREEMENT TO
  324. THIS DISCLAIMER AND YOUR RELEASE OF THE AUTHOR FROM ANY FORM OF
  325. LIABILITY OR LITIGATION.
  326.  
  327. END:
  328. ____
  329.  
  330.